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Congratulations on your purchase of a Micro Systems Research CLOCKWORKS Real Time 
Clock. Due to the excellent care taken In the design and construction of this product we are 
confktent that youll enjoy Its reliat)le operatk)n for nnany years to conie. 

Mkiro Systems Research is proud to Ixing you the highest quality products at affordable prices, 
excellent sen/ne and outstaraiing customer support 

Constructive criticism is welcomed at all times, especially comments that may lead to 
improvements in product usefulness and/or manual content or format 

If you have special requirements and would like to (fiscuss your software and/or hardware 
needs do not hesitate to drop us a note or call us at (404)928-9394. 

Well be hapf^ to help... 



Clockworks circuit design, finnware, PCB Isqfoirt, software, and usei^ tranual are copyrighted. Al oammerdai rigMs 
are reserved. No portion of fhis manual may be reproduced in any form witfraut the written permission from Mcro 
Sy^ems Ftesearch. 



Trademarks 

Ckickworks is a registered trademark of Mcro Systems Research. 
Apple, Applewwks, and Pn^)OS are trademarits of Apple Computer Inc. 
ThunderckKk is a trademark of Thunderarare tna 
Timemaster II H.O. is a trademarit of Applied Engineering. 
Appledock is a trademarti d Mountain Computer inc. 
UCSD Pascal is atrademarit of ttie regents of the University of California 
MuttiScribe is a trademark of Styleware Inc. 
MacroWoric is a trademarit of Beagle Brothers. 
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CHAPTER I 
INTRODUCTION 

Your new Ck)ckworks Real Time Ckxk will add a whole new dimenskxi to yow Apple computer. 
The applications are unlimited. Some uses are: 

-- Automatic time and dale stamping of files on disk. 

- Adding the time and/or date to any prir^ted hard copy. 

- Measurement of time elapsed between two events. 
-Recording duration of phone calls to ^formation systems. 

- Data acquisition and k)gging, plus many more... 

Ck}ckworks is a sophistk^ated real time ckxk tiiat is capable of delivering tiie time in many different 
formats. The powerful built-in firmware aHows it to emulate Thunderck)ck, Appleck)ck. and 
Timemaster, but none of tiiese can do what Ck)ckworks does. 

Your new Ck)ckworks advanced real-time ck)ck was designed in 1985 using ttie most current 
advancements in technology. We are confkient tftat you wiH find Ckx^kworks a most vakjed 
addition to your Af^. 



IMPORTANT 



*** 



We urge you to make backup copies of the software supplied right now before you proceed witii the 
installation. Any standard copy program will work such as Apple's COPYA program, or Central 
Point Software's COPY If PLUS. Remember to copy both skies of the disks, store tiie originals in a 
safe place, and use tfie backup disks only. 
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CHAPTER II 
INSTALLATION 



To property install your Clockworks card into your Apple, foHow these instructbns: 

1. Make sure your Apple is turned off. 

2. Rerrwve the Apple's top cover by gently lifting ttw l)ack end from both corners. 

3. insert Clockworks into any available stot (except in Apple 11+ and 3 in Apple He equipped with 
80-coiumn or extended 80-column cards). 

4. RepkK» the Apf^'s cover. 

5. Insert the backup of disk one supplied into your first drive. 

6. Turn on the power to your Apple. 



You shouW now have a menu on the screen. Type "1" to run a program whfch wM display several 
time/date formats on the screen. If the running time appears with the top of the screen showing 
which slot youVe selected then all is well and the installation is complete. To change the time 
setting, reboot and select the appropriate number from tfie menu. 
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CHAPTER III 

SETTING THE SWITCHES 



A bank of eight switches is located near the top and center of the card. The purpose and use of 
these switehes is as foHows: 



Swich 


Nnmal 
setting 


ON 


OfF 


1 


ON 


Reserved for future 
expansion (no effect) 


Resenrad lor future 
expansion (no effect) 


2 


ON 


Enable setting 
ttwtime 


write protect 


3 


ON 


Enable IRQ type 
Interrupt 


Disable IRQ type 
iillerrupts 


4 


OFF 


Enat>l«NMItype 
intemipts 


pisabieNMItype 
intefrupts 


5 


ON 


EnaUel permmute 
irtem^ 


Disable 1 per minute 
Nitemjpte 


6 


ON 


Enat^l per hour 
Mfiterrupte 


Disable 1 per hour 
inleraipts 


7 


OFF 


Connect CB1 fiandshaka 
Ira to aux. port 


Dtsoonnect CBI handshake 
from auxiliary port 


8 


OFF 


Connect CB2 ftandshake 
inetoaux.port 


Dficonnect CB2 hanctehake 
from auxiliary port 



Most users will not need to change the setting of these switches. The factory setting is compatible 
with all existing applications software (such as AppleWorks, DB Master, etc...) while more 
experienced users, programmers, and OEMs can configure the switches to harness additional 
features that can eliminate the need for other costly interface cards. 

Although no acckiental writes to the ck)ck have ever been noted, users can absolutely write-prcrtect 
Clockworks by turning switch #2 to the OFF positkm. This feature can be used to prevent other 
users of a system from changing the ck)ck settings. 
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CHAPTER IV 

USING CLOCKWORKS 



Your Ck)ckworks can be easily instructed from Applesoft (DOS 3.3 or ProDOS) to supply the date 
and time at any point in your (xogram. Also most application packages that require or are capable 
of using a real-time ckick are autcxnatJcaHy ccxnpatibie with Ckickworks. Some of these are: 

- Apfideworks (Apple Conr^HJter Inc.) 

- ReporWorks (Megahaus) 

- MegaWwks (Me^haus) 

- MsK^roWorks (Beagle Brothers) 

- Jeeves (Rev. 1 .1 ) PBI Software 

- Pinpoint (Rnpoint Publishing) 

- Pascal Speedup Kit (SteNatkxi Two) 

- Micro Telegram (Microcom) 

- Visklex (\r»ttorp) 

- Time Manager (Mk;rosofQ 

- Networks (Advanced Data Systems) 

- Desk Calendar II (Telephone Softvi»re Connection) 

- Data Dex (Information UnfimitBd Software) 

- Transcend 3 (SSM) 

- CPApartner (Software Dimen^ons) 

- Pf^Opartner (software dimenskxis) 

- Softerm (Softronks) 

- 0S9 (SteHationTwo) 

- Accowting Plus Super/E (Software Dimer^kxis). 

- DB MASTER (Stone Edge). 

- Cashier (High Technok)gy). 

- MKro-Courier (Mk:rocom). 

- Store Manager (High Technok)gy). 

- Z-Term, The Professkxial (Roger Wagner F*ublishing). 

Plus many more... 

For Specific Instructions on use wth the above software please consult tfie manual mciuded wth 
tfie package. Many ottier programs that use the Mountain A(^eck)ck format are also compatible 
with your Ck>ckworks card. 
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4.1 TIME AND DATE FORMATS 

Clockworks can supply the tirrte and date information in any of eight different formats. The desired 
mode is easily selected by printing a single character to the stot where Clockworks is installed. The 
following list shows the mode setting characters and the resulting formats. 

EXAMPLE: Monday, June 24, 1985. 2:35 PM and 45 seconds. 



" " MO/DD HH:MI:SS.WYY 
06/24 14:35:45.185 

% WWW MMM DD HH:MI:SS PM 
MON JUN 24 02:35:45 PM 

t WWW MMM DD HH:MI:SS 

MON JUN 24 14:35:45 

« MO,OW,DD,HH,MI,SS 
06,01,24,14,35,45 

> WWW MMM DD HH:MI:SS PM 
MON JUN 24 02:35:45 PM 

< WWW MMM DD HH:MI:SS 
MON JUN 24 14:35:45 

: W MO/DD/YY HH:MI:SS 
COMPATIBLE) 

1 06/24/85 14:35:45 

a 0W,MO,DD,YY,HH,MI,SS 
01,06,24,85,14,35,45 



APPLECLOCK 
APPLESOFT BASIC 

THUNDERCLOCK 
APPLESOFT BASIC 

THUNDERCLOCK 
APPLESOFT BASIC 

THUNDERCLOCK 
APPLESOFT BASIC 

THUNDERCLOCK 
INTEGER BASIC . 

THUNDERCLOCK 
INTEGER BASIC 

CLOCKWORKS STRING (TIMEMASTER 

APPLESOFT BASIC 

CLOCKW(»KS NUMERIC 
APPLESOFT BASIC 



As indicated, some of the formats are designed for use with Applesoft while others are used with 
Integer Bask:. 

The Applesoft formats containing colons are preceded with a quotatwn mark this is so that 
Applesoft will accept the cotons instead of printing a syntax error. The formats designed for Integer 
Basic are preceded with a space character. 



4.2 SETTING THE CLOCK 

In order to set a new time and/or date, switch #2 must be ctosed. There is a program called SET 
CLOCKWORKS on the accompanying diskette. Running this program will automatically find the 
stot used and albw you to set ttie ckxjk. Note that in setting the week youll enter a number ranging 
from to 6. with representing Sunday, 1 representing Monday and so forth, also you are required 
to enter the hours in military format (0-23). 
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4.3 SETTING THE CLOCK FRO M WITHIN YOUR PROGRAM 

In addition to the 'SET CLOCKWORKS* program supplied on dsk, there are two SET MODE 
commands t}uiit right into your CLOCKWORKS card. The advantage to using these commands is 
that ttie programmer does not have to load a lengthy program kito memory in order to set the time. 
Instead, the clock can be set by smp^ printing a string of characters to the ck)ck. The string shouM 
contain the data of tfie new ck}ck setting according to one d tfie folbwing formats: 

CLOCKWORKS SET MODE: +w MO DD YY HH MI ss <return> 

THUNDERCLOCK SET MODE: !M0 w dd hh mi ss <return> 

The spaces shown above do not have to be included as part d the sfrmg. nor does it matter how 
many spaces are used to separate tfie (figits. Each occurrence of a digit increments the format 
counter for the SET MODE used, so ZERO'S must be included in two digit values that are less tiian 
10. 

The meaning of the format notation is as follows: 

W One digit defirting the day of the week, 
where 0»Sunday,1sMoriday 6>Saturday. 

MO Two digits (01-12) definmg die month, 

where 01«January,02«February 12«December. 

DD Two digits (01 -31 ) defying the date in the montfi. 

YY Two digits (00-99) defirnng the year. 

. HH Two digits (00-23) defining the how in 24 hour format, 
where OO-Mkinight. 01- 1 AM 23- 11 PM. 

Ml Two digits (00-59) defining flie minute. 

SS Two digits (00-59) defining the second. 



The Thunderctock set modte, activated by the T character, has been included for compatibiKty with 
Thunderck)ck. Thunderclock does not handle year infomriatkm so its set nrtode does not inchjde the 
year data. The CLOCKWORKS SET MODE, activated with the '+' character, does take the year into 
account so we recommend u«ng the CLOCKWORKS SET MODE for all newly written applicatnns. 

The following Applesoft program sets the dock to MONDAY APRIL 21, 1986 4:57:23 PM. Your 
CLOCKWORKS card is assumed to be in stot #2. 

100 PRINT CHRS(4);"PR#2" 

110 PRINT "+1 04 21 86 16 57 23" 
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120 PRINT CHR$(4);"PR#0' 



You do not necessarily have to set all the data in your clock. Any portion from the beginning of the 
format can be used. For example changing line 1 10 above to: 



110 PRINT "+2 05 13" 



simf^y changes the date to Tuesday May 13 wittiout affecting the time or year information in any 
wayl The minus (or dash) "-" character if printed within the set string data has a special mearvng. It 
is used to SKIP OVER the data that you do not want changed. Changing line 110 above to the 
following sets tiie hour to 9 AM without affecting the date, minutes, or seconds. 



110 PRINT ■+- 



09* 



One application for this function b when changing to a from daylight savings time. Nso, if you want 
to change the day of week and date m tfie month to MONDAY 12th you would replace fine IfO 
above with the folk>wing: 



no PRINT "+1 -- 12" 



The following program altows a new time to be entered and sets the ckx^k according to tiie data 
supplied: 



100 SL0T=4 

110 TEXT: HOME 

120 D$=CHRS(4) 

130 PRINT "FORMAT: W MO DD YY HH MI 

140 INPUT "SET TO: •;TM$ 

150 PRINT D$;"PR#";SLOT 

160 PRINT "+";TM$ 

170 PRINT DS;"PR»0" 



SS" 



REM CLOCKWORKS' SLOT 

REM CLEAR THE SCREEN 

REM CONTROL D 

REM SHOW FORMAT 

REM COLLECT NEW ENTRY 

REM OUTPUT TO CLOCK 

REM SET NEW DATE/TIME 

REM RETURN OUTPUT TO SCREEN 



4.4 READING THE CLOCK 

Reading the date and time is very easy because alt the software drivers necessary are right on the 
card itself in a 4.096 Byte EPROM, this is 2 to 8 times larger than most other ck)ck/calendar cards. 
To read the time and/or date, all you (to is direct input and output to tiie dock, i^ue an input 
statement and return input and output to the keyboard and screen. The fottowing wiH do just ttiat 



100 D$=CHR$<4) 

110 SL0T=4 

120 PRINT DS;" INI". -SLOT 

130 PRINT D$;"PR#";SL0T 

140 INPUT ":";TM5 

150 PRINT D$;"PR #0" 

160 PRINT D§;"IN #0" 



REM CONTROL D 

REM CL0CKHC»lKS' SLOT 

REM INPUT FROM CLOCK 

REM OUTPUT TO CLOCK 

REM GET THE TIME 

REM OUTPUT BACK TO SCREEN 

REM INPUT BACK TO KEYBOARD 



After your Apple executes the above program the string TM$ will contain the date and time in tiie 
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ClockwcNrks String Format (Timemaster compatible). Adding the folbwing two lines will allow you to 
display die ck}ck on a continuous basis. 

170 VTAB 10:HTAB 10:PRINT TM$ 
180 GO TO 120 

You can also replace the colon in line 140 above with any d ttie string formats command 
characters. To i^e a numeric mode you do things a Me differently. Because the parameters are 
separated by comma's you must use a variable for each. TNs makes it easy to parse the date and 
time without resorting to string manipulation functions. To select the Ck}ckworks numerb mode and 
read the date and tkne you do tie fottowing: 

100 D$=CHR5(4) 

110 SL0T=4 

120 PRINT DS;»IN#";SLOT 

130 PRINT D$;"PR#";SLOT 

140 INPUT ■="; Dir,MO,YR,DM,HH,MI,SS 

150 PRINT D$;"PR#0" 

160 PRINT D§;"IN#0" 



TNs gives you each piece of informatkm in a separate variable. You also couki have parsed the 
string from our prevkxjs example by using the LEFT$.MIO$. and RIGHTS Applesoft commands and 
then using tiie VALUE func^ to obtain a numeric value. Once you have a vakie for ttie week or 
month you can convert it to a word tike this: 

IF M0=1 THEN M05=" JANUARY* 
IF M0=2 THEN MO$="FEBRUARY" 

etc.... 

Or you can put ttie names of all the months in a data statement and assign M0$ based on the value 
in MO. We don't have room to show you tfiat but you get the message. You obviously can do ttie 
same for the day of the week or if you want to speH out the numbers, its up toyout 



4.S REAPtNQ THE CLOCK WHILE IN W COLVMN MOPE 

Other real time dock cards have a probtem with the 80 column display when they are being used 
from Applesoft. The problem creeps in when we try to r^tore the outpiA to the saeen. If we restcve 
output with a PR#3 command to go to 80 columns, (instead of F*R#0 for 40 column screen) the 
screen is erased and any window settings are gonel CLOCKWORKS resolves this by provkJing 
you with a special command to read the date & time from within your Af^>lesoft programs wittxxit 
reinitializing your 80 cokjmn display (or the current output devKe). The format is as foHows: 

CALL 49216 + 256 * SLOT ,FH$,TM$ 

Where FM$ is a one character string indicating the read format, and TM$ is the variable name in 
whKh the cfock date will be placed. For example, the following program reads the time & date in 
the Thundercfock AM/PM mode: 
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100 CALL 49216+256*SLOT,"%",TMS 
110 PRINT TM§ 

Where "SLOT* is the number (rf the slot used. Or for sk)t 4 you cstfi use: 

100 CALL 50240, ■%",TM$ 

This command is actually faster and easier to use than the vectored I/O methods (PR#,IN#) 
descril}ed in previous sections of this manual. It also does not produce an awkward looking 
flashing cursor when the time is t)eing read continuously. This is compatil)ie with 40 column 
screens as welt. 

The f oikiwing program continuously displays the time & date in alt the read modes: 

100 PRINT : PRINT CHR$(4) ;"PR#3" 

110 SL0T=4 

120 HOME : PRINT : PRINT 

130 PRINT "MOOE", "CLOCK", "LANGUAGE", "READ FORMAT" 

140 VTAB 6 

150 FOR 1= 1 TO 8 

160 READ MODE$,CLOCK$,LANG$ 

170 CALL 49216 + 256 * SLOT,M0DE$,TIME$ 

180 PRINT M(»E$,CLOCK$,LANG$,TIlffi:$ 

190 NEXT 

200 RESTC«E 

210 GOTO 140 

220 DATA • •,"APLCLK","APLSFT","%","THDNCLK","APLSFT" 

230 DATA "S","THONCLK","APLSFT","#","THUHCUC","APLSFT" 

240 DATA ">","THUNCLK","I»TBAS","<","THONCLK","INTBAS" 

250 DATA •:","TMHO","APLSFT","=","CLKIIRKS","APLSFT" 
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4.6 HOW A PROGRAM FINDS CLOCKWORKS 

From within your program you can search and locate a Clockworks card in your Apple. The 
folbwing program does this by searching for specite signature bytes in the firmware. Do not type 
this program, it is already on your Clockworks Diskette. 

150 SLOT=0:I=1 

160 ADDR=49152+256*I:REM §CNOO 

170 IF PEEK(ADDR)=8 AND PEEK (ADDR+252) =195 AND PEEK(ADDR+253)=215 THEN SLOT=I: GOTO200 

180 1=1+1: IF I>7 THEN 200 

190 GO TO 160 

200 IF SLOT=0 THEN PRINT "CLOCKWORKS NOT FOUND": END 

210 PRINT "YOUR CLOCKWORKS IS IN SLOT ".-SLOT 

The above code may be incorporated into your own programs to bcate the clock and set the 
variable "SLOT" whk;h is usually used later to read the ck)ck data. 



4.7 PRODOS TIME AND DATE STAMPING 

One of the nice features of Clockworks is its automatic emulation of Thunderck)ck. This albws 
ProDOS to automaticaily time and date stamp your files and programs when they are saved or 
updated. The ProDOS (or more accurately Basfc.system) "CATALOG" command displays ttie date 
& time of when the file was originally created and that of when it was last modified. Every time you 
save or update a file or program, ProDOS calls upon Ck)ckworks to supply the date & time. 
Appleworks, Reportworks and all other ProDOS based applications can automatically read 
Clockworks to time & date stamp your files. 



4.8 DOS 3.3 TIME AND DATE STAMPING 

Unlike ProDOS and Pascal, DOS 3.3 does not normally stamp files saved to disk with the date or 

time information, but a program is included on your Clockworks DOS 3.3 disk tiiat installs the 

necessary patches to altow the date and/or time data to be added to all files SAVED, BSAVED, or 

RENAMED. 

The program that automatk;ally installs these patches for you is available on ti)e DOS 3.3 disk 

supplied and is easily selected from ttie bootup menu, or can be executed by typing ttie tolbwing 

from Bask:: 

RUN INSTALL DOS DATE STAMP PATCH <PRESS RETURN> 

Once tiiis program is executed, several date/time formats are displayed with an an'ow pointing to 
the first one. This is the recommended format because it provides tiie year information. To select 
this format simf^y press <RETUfM>. To select an alternative format use ttie up/down arrow keys 
then press <RETURN>. 

Another display now appears showing tiie format you selected witii a highlighting bar underneath it 
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which indicates the oortion of the strina to be used. Bther acceot the oortion shown by pressing 
<RETURN> or adjust ttie fieid with the following commands: 



Shortens the tield trom the left edge 
Lengthens the field from the left edge 
MovefJMtori^ 
Move field to left 



If you want to go back to change your format selection, you can press <ESCAPE>. Press 
<RETURM> to complete the Installation. 

Nk)w the DOS in memory has your modiricatk>ns installed and you may format as many disks as 
you like with the DOS 1NIT* command and then move any files from the software disk you want to 
use to the newly formatted disk. To directly install the new DOS on your disks you can use a utility 
program called THE FILER" availabb from Central Point Software that wiH simply replace the 
disk's DOS with ttte DOS in memory. 

The above described patch is compatible with most unprotected software . Any new files SAVED. 
BSAVED, or RENAMED will have the dateAime appended to the filenames. The INIT command wiH 
also add the date/lime to the boot program's name. 

If you need to access a time/date stamped file wNle running an unmodified version of DOS you can 
do so by typing the full name of the file inchjding the date/Hme with exactly ttte same number of 
spaces In between or you can easily pateh DOS directly in memory to cause it to ignore the 
dateAime stamp. To do tNs^pe: 



POKE -19965, N 
POKE -22653, N-1 



Mrrats compare size in catatog seardi routine 
limits compare size in OPEN text file handler 



Where N is a number between 1 and 30 and indbates how many characters from the beginning of 
the filename are significant This number is cateulated to be 30 - (length of date/time stamp). If 
youVe used the default format and portton, (ie 10/23/86) with the leading space, then N wouM be 
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CHAPTER V 

THE ULTRASONIC REMOTE CONTROL OPTION 

The ultrasonic remote control option for CLOCKWORKS aHows your Apple to transmit control 
commands to your BSR X-10 command console. This gives your computer the at}itity to control 
lights , appliances, and most other devices that operate on standard AC current. The ultrasonic 
command console is available from several suppliers as the 'BSR X-10 Model UC301' or from 
SEARS as model X-10-014301. This is the model that operates with the handheld cordless 
confoHer. 



5.1 INSTALLING THE BSR X-IO IMTERFACF 

To install the BSR X-10 remote control interface, foltow this procedure: 

1. Turn OFF the power to your Apple. 

2. Remove the Apple's cover by lifting the back end from both corners. 

3. Unplug your CLOCKWORKS card 

4. Locate the AUXILIARY connector on the card. (This is the goW connector at the top right hand 
corner of the printed circuit board. 

5. Locate pin #1 and pin #16 on the two opposing corners of the connector, (refer to AUXILIARY 
connector pinout if necessary) 

6. Plug one end of the BSR cable on pin land the other on pin 16. 

7. Place your CLOCKWORKS card back Into the stot 

8. Replace the Apf^'s cover. 

9. Now. turn the power back <0N>. 

10. Point the transducer element (k)oks like a small speaker) to your BSR X-10 COMMAND 
CONSOLE. For reliable operation, the distance between the BSR command console and the 
trar^ucer element shouki not exceed 10 feet 



Clockworks User's Manual 



Page 1 7 



5.2 USING THE BSR X-IO COMMANDS 

Your BSR console has 22 command buttons. Buttons 1 through 16 select devices 1 through 16 
while the other 6 iMittons select the functions: ON. OFF. BRIGHT. DIM. ALL UGHTS ON. and ALL 
OFF. These can be activated manually by pressing the desired buttons on ttie BSR console itself or 
via your CLOCKWORKS card by outputting the characters corresponding to these buttons as 
shown below: 



CHARACTER 


BUnON 


A 


1 


B 


2 


C 


3 


D 


4 


E 


5 


F 


6 


G 


7 


H 


8 


. 1 


J 


" 


K 


-jU 



CHARACTER 


BUTTON 


L 


12 


M 


13 


N 


14 





15 


P 


16 





ON 


R 


OFF 


S 


BRkSHT 


T 


DM 


U 


ALL UGHTS 
ON 


V 


AIL OFF 



For example, to tum <0N> modules 1 and 3 you would do the following: 



10 PRINT CHR$(4);*PR#4" 

20 PRINT "ACQ" 

30 PRINT CHR$(4);"PR#0" 



REM CLOCKNC«KS IN SLOT 4 

REM 1 AND 3 <0N> 

Rm RETURN OTTPOT TO SCREEN 



For the following examples youH need one lamp module with its unit code dial set to 1, and one 
appliance module with its dial set to 3. Make sure that the modules and the command console are 
all set to the same house code. Rug both modules into AC outlets nearby. Plug an incandescent 
lamp into the lamp module and a small appliance into module 3. (A transistor radb, portable TV 
set. or any device that you can easily teN whether it is on or off) 
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Turn on the lamp and appliance from their power switches and verify your installation by pressing 
buttons 1 , tf»n 3, then ON. The appliance and lamp should have come ON. If this did not happen 
verify the following: 

1. The lamp and appliance are both turned <0N>. 

2. The HOUSE and UNIT CODE dials are set correctly. 

3. you are pressing the buttons long enough for the modules to respond. 



The following simple program allows you to enter BSR commands from the keyboard and send 
them to your BSR console. 



100 SL0T=4 

110 DS=CHR$(4) 

120 TEXT: HOME 

130 INPUT"BSR COMMANDS :";CM$ 

140 IF CMS="" THEN END 

150 PRINT D$;*PB#";SLOT 

160 PRINT CM? 

no PRINT D$;"PR#0" 

180 GOTO 130 

The above test program is available on your ck)ckworks disk and is named 'BSR.TESP. Execute 
the program by typing: 

RUN BSR. TEST <RETaRN> 

The fc^owing line appears: 

BSR COtOUNDS: 

Now enter the toUowing responses and observe the results. 



WHAT YOU TYPE 


RESULT 


AQ 


TURNS ON THE LAMP 


AR 


TURNS OFF THE LAMP 


CO 


TURNS ON THE APPLIANCE 


CR 


TURNS OFF THE APPUANCE 


U 


TURNS ON THE LAMP 


V 


TURNS OFF THE LAMP 


ACQ 


TURNS ON THE LAMP AND APPLIANCE 


ACR 


TURNS OFF THE LAMP AND APPUANCE 
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5.3 BRIGHT AND DIM CONTROL 

The bright and dim commands can be used with lamp modules and wall switch modules to control 
the intensity level of incandescent lighting. The fdlowing program demonstrates the dim 
command: 



10 PRINT CHRS|4);"PR#4" :REM CLOCKWC«KS IN SLOT 4 

20 PRINT "AQTTTTTTTTTT" 

30 PRINT CHR5M); "PRIO'tREM RESTC«E OUTPUT TO SCREEN 

Type in the above program and run. 

The "A" selects device 1 (THE LAMP) and the "Q" turns it <ON>.The T^ dim the light in steps. Now 
if you change line 20 like this: 

20 PRINT "ASSSSSSSSSS" 

and re-run the program, you shoukl see the light brighten up again. 

Instead of using multiple S's and T's you can issue a duration code "*' to select the amount of 

brightening or dimming and have it performed in one 

continuous sweep instead of steps. Now change line 20 to the fdiowing and re-run. 

20 PRINT "A*PT" 

The '*' is recognized by your CLOCKWORKS card to indicate that the next character (IN THIS 
CASE 'P) is a duratton code. The duration code can be any character from 'A" through T. With 
"A" being the shortest duration code and "Z" the tongesL The default duratton code is ttie letter "E" 
and is used by the firmware urJess the duration cor^ feature is used. 

The foitowing program shows how you can control the lamp brightness based on time. 

100 TEXT: HCWE 

110 D$=CHR§(4) 

120 SL0T=4 

130 PRINT D$;"PR|";SLOT 

140 PRINT D$; "INI"; SLOT 

150 INPUT "=";W,MO,DD,YY,HH,MI,SS 

160 PRINT D$;"IN#0" 

no PRINT D$;"PR#0" 

180 VTAB 10: HTAB 15: PRINT ■SEC(MiDS:";SS 

190 PRINT D$;"PR#";SLOT 

200 IF SS < 30 THEN PRINT "AT" 

210 IF SS >= 30 THEN PRINT "AS" 

220 PRINT D$;"PR#0" 

230 GO TO 130 

The above program dims the lamp if the seconds count is less than 30 and brightens it if the 
seconds count is 30 or more the result is that the lamp dims then brightens once per minute. 
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CHAPTER VI 

FOR ASSEMBLY LANGUAGE PROGRAMMERS 



It is easy to use Ck)ckworks from assembly language if you choose to use the onboard firnwvare. 
To do so you simply set the mode and then read the clock. 



g.1 ?EniN9 THE MOPE 

To set the mode from assembly language you load the accumulator with the mode selection 
character and you do a 'JSR to $CNOB, where N is the sk)t#. Here's an example using stot #4: 



LDA ♦'=' ; SELECTS CLOCKWORKS 

JSR $C40B /NUMERIC MODE 



6.2 REAPINQ THE CLOCK 

To read the clock from assembly language, you set the mode by loading the accumulator with a 
mode selection character and you execute a jsr $cnob where N is the sbt number, then you do a 
JSR $CN08. On return the time string in the selected format will be located in the keyboard input 
buffer (starting at $200) and terminated by a carriage return ($8D). An example for reading the 
ck)ck kicated in ^t 4 is: 



LDA #'=' 

JSR $C40B 
JSR $C408 
RTS 



SET MODE TO CLOCKWORKS NUMERIC 
READ CLOCK TO INPUT BUFFER 
OR WHATEVER COMES NEXT 



If you want to display the sfring you can use the following subroutine: 



NEXT 



END 



LDX to 




LDA 5200, X 




JSR COHT 


MONITOR OUTPUT ROUTINE 


CMP f$8D 


CHECK IF END OF STRING 


BEQ END 


YES— EXIT 


INX 


NO DO NEXT CHARACTER 


BNE NEXT 


BRANCH ALWAYS 


RTS 
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6.3 THE MOUNTAIN CLOCK FORMAT 

To read tiie time string in mountain computer's ^pleck}ck format from macNne language, you do 
not print a space to tfie "^OOESET" entry point in the firmware, Ixit ratfier you have to set the mode 
directly by storing a ZERO in the scratch pad memory address (MODE) k)cated at $5F&i-n where n 
is the slot number. 

This example is for slot 4: 



LDX t$04 
LDA »$00 
STA 55F8,X 
JSR $C408 



After executing the above code, the time and date in the Appleciock format will be in the keyboard 
buffer starting at $200. Remember that the first character at $200 will a quotation mark. The 
time/date will folbw starting at $201 and is terminated with the carriage return character ($8D). 

6.4 SEHING THE CLOCK FROM ASSEMBLY LANQUAGg 

It is very easy to set the ckxk from within your assembly language programs due to the SET MODE 
features built right into Qockworks. Simply output the SET MODE character (-t- or 1) to the ck)ck via 
$CnOB, where n is the sbt number. Follow that with the data characters and end it with a caniage 
return character ($8D or $0D). This feature of Clockworks is extremely useful for dedicated 
appKcatk)ns of ttw Apple computer. 

The fdbwing program sets the ck)ck to TUESDAY APRIL 22, 1986 5:5824 PM. 



LDX l$00 
NEXT LDA STRING, X 
JSR $C40B 
CMP t$8D 
BEQ END 
INX 
BNE NEXT 



INITIALIZE COUNTER 

GET X-TH CHARACTER 

OUTPUT TO CLOCKWORKS IN SLOT 4 

CHECK IF END OF STRING 

EXIT LOOP IF END OF STRING 

INCREMENT COUNTER 

BRANCH ALMAYS 



STRING ASC '+2 04 22 86 17 58 24 ' 
DFB $8D 

END BRK ;0R WHATEVER COMES NEXT 

In the above , the spaces in the string are not necessary. They are inckjded in this example simply 
to make it visually easier for you to analyze ttie date & time setting. 

If you shorten the string's length to the fdbwing: 
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STRING ASC '+2 04 22' 

Only the date is set. The time and year informatkm is not affected. You can also selectively set any 
portion by using the skipover "-" feature. For example changing the string to: 

STRING ASC '+ — 09' 

Here the hours are changed to 9 AM, while everything else remains intact 

Also, you can set the time very precisely (to the nearest 1/32 of a second) by printing the letter "Z" 
somewhere in the string. It make good sense however to place it right after the V or 'I" characters. 

6^ READING THE CLOCK WIT HOUT RRMWARE 

For most applicatbns you would want to use the built in firmware to read the ckxk simply because 
it is easiest But if you need to work directly with the hardware registers because you are using 
interrupts or you want to write aspeciai driver, you can write your program following these steps: 

1 . Save the status of control register A. 

2. Select the address of a ck)ck register. 

3. Read the data. 

4. If roikwer occurred, start over. 

5. Repeat steps 2,3, and 4 for all data needed. 

6. Restore status of confrol ngt^u A. 

The fotk>wing table shows the address code for any digit 



ADORESSCODE 


NCfTATION 


ACCESSTO: 


$00 


SI 


UMTS DIGIT OF SECONDS 


$01 


S10 


TENS DKSrr OF SECONDS 


$02 


Mil 


UNITS DIGIT OF MMUTES 


$03 


MilO 


1ENS DIGIT OF MINUTES 


$04 


HI 


UNTTSDIGITOF HOURS 


$05 


H10 


TENS DIGIT OF HOURS (NOTE 1) 


$06 


W 


DIGIT FOR DAY OF WEEK 


$07 


D1 


UNITS DIGIT OF DAY OF MONTH 


$08 


D10 


TENS DIGITOF MONTH (NOTE 2) 


$09 


M01 


UNTTSDIGITOF MONTH 


$0A 


MO10 


TENS DIGIT OF MONTH 


$0B 


Y1 


UNTTSDIGITOF YEAR 


$0C 


Y10 


TENS DKSrr OF YEAR 



NOTE 1 When reading the tens digit of the hour, only bits and 1 are significant Bit 3 is high for 
24 hour format, )ow fotmjPM. If in AM/PM format then bit 2 indk^ates PM when set and 
indicates AM when clear. 
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NOTE 2 When reading the day of the month Bit 3 and 4 are not significant. Normally these are 
reset to which indk;ates that the ck}ck is in the USA/Gregorian method for leap year 
detectKMi. 



There are two other registers in the ckxk that have specialized use: 



1) Reset pre-stages: a write to clock address $D resets 5 DiVIDE-BY-TWO stages before the 
seconds register providing a precise way to set the time to the nearest 1/32 of a second. 

2) Select reference signals: by writing a $E or $F to the address latch, reference signals of 1024 
Hz, 1 per second, 1 per minute, and 1 per hour are output from the clock to the PIA 
handshake lines CA1.CA2,CB1, and CB2 respectively. See the program TBI" In the section 
entMed "Reading the time from within an interruf^. 



6.6 SENDING BSR COMMANDS FROM ASSEMBLY LANGUAGI= 

BSR control commands can be sent to your BSR command console by outputting the selected 
characters to the "WRITE" entry point ($CnOB} in the dock's firmware. This sample program 
demonstrates Ms: 





LDX #500 


NEXT 


LDA COMMANDS, X 




BEQ END 




JSR §C40B 




INX 




BNE NEXT 


END 


JMP $FF65 


COMMANDS 


ASC 'ABCQ A*WT A*WS' 




DFB 500 



ISLOT 4 



;BEEP £ EXIT TO MCWITOR 



The BSR string above selects devices 1 ,2 & 3 and turns them <0N> then sets the duration to "W, 
dims device 1 (it better be a lamp), sets the duratk)n to "K" and brightens it about halfway. 
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CHAPTER VII 

USING CLOCKWORKS FROM PASCAL 

The Pascal support programs are found on the Pascal disk supplied with dockworks. in the foBowIng subchapter youll 
find instnx:tky)s fcir retooting tttese programs to your Pascal disks. 

7.1 rNSTALLING THE CLOCKWORKS UNIT INTO YOUR PASCAL SYSTEMUBRARY 

The CLOCKWORKS Itvary intrinsic unM gives Pascal programs the capab% to use the CiockKxy^ 

The compiled and Knked unit is provkled in the file CW.CLOCKWORKS.LtB. ready to instaH into your own 

SYSTEM.UBRARY on your t)oot disk If you-ie not iamKar with how to do this, foNow these step-by-step diradfons: 

Put the CW: disk in your second drive. 

Enter the F(iler by pressing F at the Command prompt. 

Transfer CW£LOCKWORKS.LIB to your boot disk 

Type TCif : CLOCKWORKS . LIB, *$ then press RETUTVi 

Press to Q(uit from the Ftor. 

Take the CW: disk out of ttw second drive, and rsplaoB it with a copy of the APPLE2: dsk (supplied wtth yow Apple 
Pascari system). 

Execute the Librarian program. Type xapple2 : library then press RETURN. 

Type *LiB.coocforthenameoftheoutputcodefile,thenprBssRETURN. 

Type * for the name of the link code file, then press RETURN. 

Type = to copy everything from your oUSYSTEULIKMRY into ttie new library. Ooni press RETURN for this one. 

Type N 'CLOCKWORKS. LIB And pTBss RETURN to Select the new Knk oode f He. 

Type 1 to select CLOCKWORKS and press SPACE. Now type the number of the first empty ^sfoT in the new ibravy at 
the bottom of the screen. For example, if 7 is the first place in the new fbrary that doesnl have any unit name after it, type 
a7andprBssRETURK This wM copy the aOCKWORKS unit into your new librsry file. 

Press to quit, then press RETURN when the ttxarian says "Notice?*. 

Press p to enter the Filer. 

Type R'CLOCKHORKS . LIB, 'SYSTEM. LIBRARY and pfBss RETIA^ to remove the old fies which have been combined 
into LIB.CODE. Press Y to i^xlate the disk. 

Type c*LiB. CODE, 'SYSTEM. LIBRARY tochangs UB.CODE hto the now library file. 

Type K*tfwn press RETURN to K(njnch the disk. Press Y to complete the actton. 

You're now done updating your system library. If you want Clockworks to automatically update your Pascal system date 
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whenever you start using Pascal, There are two programs on the supplied disk that you may use aBaSYSTEM.STARTUP 
program to accomplish the task. 

if you want your Pascal system to start ou with a graphic cfc>ck face irni^ showing the curretit Ck>ckworks tinw^ 

TCW : TiCKTOCK . CODE, *SYSTEM . STARTUP and press RETURN. 

If you want somtf hing less ornate, and you still want the ^tem data updstted to the currertt Ckxkworits dale, type 

TCW: STARTUP .CODE, * SYSTEM. STARTUP and pTBSS RETURN. 

Type to quit from the Filer when you're done. 

For advanced Pascal programmers: 

If you have installed units in your library that use segment numlwr 26. you shouki edit and recompile 
CLOCKWORKS.TEXT to change its code segment numlwr in the first line of the program to a number thsd doesnl 
conftet with the other units in your library. Be sure to link your recompiled CLOCKWORKS unit with CWASM.CODE 
before installing it in the fibrary. Any programs that use the urtitwi have to be recompiled alter revising the ibray, so that 
they will use your revised segment number. 

72 USING THE CLOCKWORKS UNIT WITH PASCAL 

By using the CLOCKWORKS intrinsic unit, your Pascal programs are provided with the DATE, TI|y£OFDAY. 
CLOCNNFO. and SETTIME procedures to read and set the Clocfcworfcs real time dock/calendar card. 

To use the facilities of the CLOCKWORKS unit, the program must have alfiES dedaralkxi containing the identifier 
CLOCKWORKS, immedisaely atterthe program heading; for exanpie: 

PROGRAM TIMELY; 

USES APPLESTUFF, CLOCKWORKS; 

For mors on units, consutt the Pascal programmer's manuals. 

The CLOCKWORKS procedures are compatible with their namesakes in the Apple lAPPLESTUFF unit. If you produce 
Pascal programs to nin on bcMh the Apple Hand the Apple IH compters, you can now use the same ck)ck access 
procedures for both machines by dedaring USES CLOCKSTUFF on the Ap(^ N versnn. 

The DATE procedure has the fonn 

DATE(D) 

where D is a string variable to oxitain the information returned by DATE. The returned ei£^-character string has the 
forniat YYYYMMDD, where YYWis the year (from 1980 to 2079). MMis the month (asanumber from 01 to 12). and DO is 
the day of the month (from 01 to 31 ). Hence, the date July 4. 2076 wouki be represented as 20760704. If there is no 
Ckxdcworks card presertf, 00000000 is returned. 

The TIMEOFDAY procedure has the form 
TIMEOFDAY(T) 
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where T is a string variable to contain the information returned l^ TIK/EOFDAY. The returned six-character string has the 
tonnal HHMMSS. where HH is the hour in 24-hour lonral (trom 00 to 23). MMisthe nrnOi (from 00 to 59), and SS is the 
second (from 00 to 59). The time 3:3524 PM would be represented as 153524. Nihere's no Ctodawxte cad present. 
000000 is returned. 



The CLOCKtNFO procedure has the term 

aOCKINFO(YEAa MOK DAY. DAYOFWK. HR MH, SEC. THOU) 

where ay of the parameters are irrteger vstfiables used lo contain the date »)d time intormation returned by CLOCI^^ 
Alter a CLOCKINFO can, the variables haw the foHowing values: 



YEAR 


year 


1980..2079 


MON 

DAY 

DAYOFWK 

HR 

MN 


month 

day of the month 

dey oi the week 

hour 

minilB 


1..12 {Jan..Dec) 

1..31 

1„7 (Sua.Sat) 

0.23 (24hourtomiat) 

0..59 


SEC 




0..S9 


THOU 


dummy milseconds 






H there is no CkKkworie caid present. £i values are s^ to zera 

The SETTIME procedure sets the Ck)ckworks time and dale. Ithastiieform 
SETT1ME(T) 

where T is an ei^een-character string representing the dsde and time to be wrttten into the Ck)ckworfcs cad. Thishs 
the format 

YYYYMMDDWHHM4SSUUU 

where the fields are: 



YYYY 


year 


1980..2079 


MM 


month 


01 ..12 (Jan..Dec) 


DD 


day of the month 


01 ..31 


W 


day of the week 


1..7 (Sua.Sat) 


HH 


hour 


00..23 


NN 


minute 


00..59 


SS 


second 


00..59 


UUU 


dummy miiseconds 


000..999 (ignored) 



The Ckickworks carel auomatnally sets Hs internal milliseconds to zero when SETTNyNE is calted. The UUU part of the 

fc>rmal is tor compatibility with the Apple Utverson of SETTIME. 

SETTIME doesnl check the Hifomrtatnn before writvig it to the ctock. 

In enter to change ttie time anl/or date settings on the Ctockwofks ca«d, Switch 2 on the cani must be ON. 
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CHAPTER VIII 

ABOUT THE AUXILIARY I/O PORT 

Some real time clocks include one or two bits of I/O that are used with an optional module for BSR 
control. Ckickworks has a 16-pin auxiliary connector with a full 8-bit bidirectional port with 2 lines 
for handshake. Additionally, the connector supplies +5 votts,-5 voits,-i-12 volts, -12 volts and a 1 
MHz clock signal. These signals are available for use by external circuits so long as they are 
properly designed and do not overload the power supply in your Apple. The applicatbns lot tNs 
auxiliary connector are limited only by your imaginatk>n. Some of the applications inckide BSR 
cotiticA, direct confrol of external devices, printer driver, A/D and D/A conversion, plus many more. A 
BSR interface is available for Ck)ckWorks which is used in corijunctkxi witti the BSR X-10 home 
control system to control lights and appliances from your Apple computer.(See the section entitled 
THE ULTRASONIC REMOTE CONTROL OPTION") 

8.1 AUXILIARY PORT PINOUTS 

The pinout for the auxiliary connector is as follows: 



Pirn 


RJNCT10N 


NOTES 


1 


GND 




2 


-12V 




3 


+12V 




4 


-5V 




5 


1MHz 




6 


+5V 




7 


CB2 


(1) 


8 


CB1 


(2) 


9 


PBO 




10 


PB1 




11 


PB2 




12 


PB3 




13 


PB4 




14 


PBS 




15 


PB6- 




16 


PB7 





TOP RIGHT of P.C.B. 



IS 



16 



DIAGRAM TO IDEmTFY 
AUXILIARY CONNECTOR 
ANDPttKXn' 



(1) To mabte the CB1 handshate fine switch «Simi^ be opened and switch «8nu^ be ctose^ 

(2) To enable the CB2 handshake fine switch M must be opened and s«Ach«r must be ck)sed(reterlo section 3). 



For detailed information on programming this port please refer to the Motorola MC6821 or the 
HITACHI HD6821 PIA data sheet 
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8^ EXAMPLE INPUT PROGRAMMING 

To demonstrate the use of the input function of the auxiliary port the foRowing two programming 
examples are provided here. The irst is an Applesoft program that configures the port for input tfien 
reads the )oq\c levels at the 8-bit port and disjplays it on the screen as a number ranging ftomOto 
255. 



100 TEXT:H(»tE:SL0T=4 

110 PB» -16254 + SL0T*16 

120 CB= PB+1 

130 POKE CB,0 

140 POKE PB,0 

150 POKE CB,4 

160 DATA<= PEEK(PB) 

170 HTAB1:PRINT SPC(3); 

180 HTABl: PRINT DATA; 

1»0 GOTO 160 



REN CLEAR SCREEN, CLOCK IN SLOT 4 

REM ESTABLISH HDORESS F(» PC«T B 

REM CONTROL REGISTER B 

REM SELECT DATA DIRECTICM REGISTER 

REM MMCE ALL LINE INPUTS 

REM SELECT PORT FOR ADDRESSING 

REM READ THE DATA AT PC«T 

REM WIPE OLD DISPLAYED VALUE 

REM PRINT NEW VALUE 

REM REPEAT 



The tbitowing is a similar functk)n assembly language program that programs the port for input, and 
continuously reads the data. It displays tfte the data in hexadecimal fomtat ranging from $00 to $FF. 



; PRINTS HEXADECIMAL BYTE IN ACC 
.-OUTPUT ASCII IN "A" TO ACTIVE OUTPUT DEVICE 
;PORTB ADDRESS F(» SLOT 4 *$C0(slot+S)2" 
; CONTROL REGISTER ALWAYS (m, PAST ITS PC«T 

; SELECT DATA DIRECTI(»I REGISTER 

MAKE ALL LINES INPUT 

SELECT ACCESS TO PC«T 

;READ PORT 

;PRINT VALUE AS TWO HEX DIGITS 

.BACKSPACE CHARACTER 

.•BACKSPACE TWICE TO THE BEGINNING 

.BRANCH ALWAYS AND REPEAT 

The above programs are intended to describe a simple uiput use of the auxiliary port TNs port can 
be also be used to receive data from ottier digital equipment external keyboard, anabg to digital 
converters, and more. With the above proc^am, an external devk» couki signal tfie presence of a 
new data byte by momentarily taking the CB1 input low. This wouM cause BIT? of the CRB to be 
set A program couM easily test this with the BfT'mstnjctkx). If CRB bit 7 is set you can read PORTB 
whKh clears CRB bit 7. 



PRBYTE 


EQU 


$FDDA 


COUT 


EQU 


5FDED 


PORTB 


EQU 


$C0C2 


CRB 


EQU 


POTTB+1 




LDA 


t$00 




STA 


CRB 




STA 


PORTB 




LDA 


t$04 




STA 


CRB 


LOOP 


LDA 


PORTB 




JSR 


PRBYTE 




LDA 


«$88 




JSR 


COUT 




JSR 


COUT 




BNE 


LOOP 
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8.3 EXAMPLE OUTPUT PROGRAMMING 

Following the example format of tfte previous section, the following two programs demonstrate 
programming the auxiliary port for output. The first example is in Applesoft, it starts t}y initializing the 
port for output and then continuously increments the vakje stored in the port until it reaches 255 (aH 
high), tiien it recycles. 



100 TEXT: HOME :SL0T=4 

110 PB= -16254 + SLOT* 16 

120 CB= PB+1 

130 POKE CB,0 

140 PCaCE PB,255 

150 PCMCE CB,4 

160 FOR X=0 TO 255 

170 PCMtE PB,X:NEXT 

180 GOTO 160 



REM CLEAR SCREEN, CLOCK IN SLOT 4 
REH ESTABLISH ADDRESS FOR PORT B 
REM CONTROL REGISTER B 
REM SELECT DATA DIRECTION REGISTER 
REM HAKE ALL LINES OUTPUTS 
REM SELECT PORT FOR ADDRESSING 
REM LOCa> FOR ALL POSSIBLE VALUES 
REM OUTPUT TO PORT AND REPEAT 
REM REPEAT FOR NEXT 1009 



The assembly language verskxi of this is shown befow: 



WAIT 


EQU 


$FCA8 


PORTB 


EQU 


$C0C2 


CRB 


EQU 


P(»TB+1 




LDA 


f$oo 




STA 


CRB 




LDA 


#5FF 




STA 


PORTB 




LDA 


«$04 




STA 


CRB 


LOOP 


LDA 


COUNTER 




STA 


PORTB 




LDA 


DELAY 




JSR 


WAIT 




INC 


COUNTER 




JMP 


LOOP 


DELAY 


DFB 


$80 


COUNTER 


DFB 


$00 



; APPLE'S DELAY ROUTINE 

;PORTB MDRESS FOR SLOT 4 "$C0(slot+8)2» 

.-CONTROL REGISTER ALWAYS CWE PAST ITS PORT 

; SELECT DATA DIRECTION REGISTER 



MAKE ALL LINES OTTPUT 

SELECT ACCESS TO PORT 

GET COUNT 

OUTPUT COUNTER VALUE 

GET "SLOW DOWN" VALUE 

DELAY EXECUTION 

ADD ONE TO VALUE TO BE CXJTPUT 

REPEAT 



Note that a changeable delay value of 80 was used to allow easy viewability of signal level by 
using a fogic probe. To view and measure higher frequencies you may employ an oscilloscope or a 
cfigital frecj^ncy counter. 

This example is intended for denrjonstrating ttie kind of programming used to gain access to the 
o^put port function. You wouki need iNs information if you intend to use ttiis port for direct control 
of external devwes. to control relays, or to send files/data to another devne (such as computers, 
printers, or digital to analog converters). You can also cause an automatic tow tevel pulse to be 
generated on handshake output CB2 every time a new vafoe is stored by replacing the "LDA 
t$04 " above with "lda tS2C". or by using "lda $24". a tow level on CB2 is affected to be driven 
back Ngh when the external devne signab with a bw pulse on CB1. 



Clockworks User's Manual Page 30 

CHAPTER IX 
USING INTERRUPTS 

Your Clockworks has the ability to generate both IRQor NMI interrupts in four different frequencies. 
TNs allows for nmmum interrupt overhead and maximum flexibility. 

9.1 WHY USE INTERRUPTS? 

Interrupts generated at prectotermined intervals add a new dimension to tfie processing capability 
of your Apple. Interrupts allow your Apple to do two things at once. For example, as your word 
processing program is running on your Apj^e an interrupt occurring once per minute can 
continuously display the trnie on the screen without affecting your word processor program. Other 
applications include gathering data from the auxiliary port at exact intervals and placing it in a 
buffer to be processed by the 'foreground* program rurtfiing at the same time. As ^ can see use 
(rf inteniipts can satisfy many specialized needs that vroukl otherwise tequke two computers. 

9.2 SELECTING THE TYPE AND FREQUENCY OF INTERRUPTS 

You can select one of two types of interrupts. The interrupt request (IRQ) and the nonmaskable 
interrupt (NMI). IRQ type interrupts can be disabled with the SEI' 'set interrupt disabte" instructton, 
while NMI type interruf^ always take prtority and camcA be i^xxed by the processor. 

To select IRQ type interrupts, switch #3 must be on (ctosed) and switch «4 must be off (open). 
Conversely, to select NMI type interrupts, switch #3 must be off (open) and switch #4 must be on 
(closed). Non-Maskable interrupts shouM not be used with a disk operatkig system or any other 
programs that depend on timing by software such as communk:ations software that uses timed 
kx>ps, software that uses the tape or disk I/O, etc... , unless this interrupt is disabled at the source 
before entering time sensitive code and re-established aftenvards. The IRQ can be used in 
conjunction with most existing software provided that the interrupt disable flag in the 
mk;roprocessor is setwitti the *$£!' instructton before entering time sensitive code and cleared witii 
the 'CLI' instruction immediately afterwards. To select an interrupt frequency you must set the PIA 
(Peripheral Interface Adapter) control registers as foUows: 



COMTROLREGCHA 


CONTROL REG. CRB 


FREQUENCY 


NOTES 


04 


04 


none 




05 


04 


1024 per second 




OC 


04 


1 persecond 




04 


05 


1 per minute 


(1) 


04 


OC 


1 per hour 


(2) 



(1 ) To seled interrupts of one per minute switch #5 should be on white switch «8 should be off. 

(2) To select interaipts of one per hour switch «6 should be on while switch #7 should be off. 
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9.3 EXTERNAL SOURCE INTERRUPTING 

Ck)ckworks has tfie ability to generate interrupts when signalled by an external device. The 
external device can be as simple as a push button svwtch or as complex as heart rate monitoring 
equiptnfient. Two inputs are available for this purpose and are called CB1 and CB2. These can be 
set up from your software to be active on high-to-tow (negative) or on low-to-high (positive) 
transitions by simply storing the values shown below in CRB, addressed through $C0(n+8)3, where 
n is tfw sk>t number. 



SWITCH SEHINGS 


CRB 


SOURCE 


ACnVE TRANSITION 


SW#60FF.SWI80N 


05 
07 


OBI 
CB1 


NEGATIVE 

posmvE 


SW»50FF,SWf70N 


OG 
10 


CB2 
CB2 


NEGATIVE 
POSITIVE 



When an interrupt occurs, you can find out where the interrupt came from by examining control 
register B (CRB). Bit 7 of tfie CRB will be 'set* if the interrupt came from input CBI and bit 6 will be 
set if the cai^e was CB2. 



9.4 PATCHING DOS 3.3 FOR INTERRUPTS 

A popular disk operating system for the Apple is DOS 3.3 whk^ is incompatible with intemjpts due 
to a conflbt with the firmware built into the Apple ROMS. Both DOS 3.3 and the monitor firmware 
use a page zero UxaHaon ($45). If an IROintemjpt occurs during the executkm of DOS routines the 
monitor changes the value in $45 and DOS may k)ose a variable. The easiest and most common 
sokitkm to this problem is to patch DOS to use a different address for variable storage. The 
fblk)wing program wiH modify DOS 3.3 right into memory to make it compatible with intenrupts (this 
program is available on your Dockworks Diskette and b called "DOS 3.3 INTERRUF^ PATCH"). 

100 REM PREPARE DOS 3.3 FC« INTERRUPTS 

110 READ A : IF A <> THEN PCMCE A, 70: GOTO 110 

120 READ A : IF A <> THEN POKE A, 44: GOTO 120 

1000 DATA 41267,41278,41304,41406,41427,41448,41463,41465,41473,41676,42855,42879,44474, 

44554,44628,44632,48851,48918,48953,48981,48983,48987,49053,49059,49061,0 
1010 DATA 47622,48548,0 

The DOS on the ciockworie disKette is adready patched. Ifyou wart to make Memipt oorr^ibtediskssiyou havetodo 
is boot wtth the Glodmrarte DOS 3.3 disk and inliafize as many blank disie as yw 

9.5 READING THE TIME FROM WTTHIN AN INTERRUPT 

When using interrupts to read the dkxM you shouM not use the built in firmware for several reasons. 
One is that the time is read into the keyboard buffer virtifch may contain other vital data. Another is 
that the Ck)ckworks ROM firmware is mapped into the $C800-$CFFF space and if you have other 
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cards whose firmware maps into this address space in your Apple then things will go haywire. 
Another reason is that you'll probably only want to read certain registers from the dock whrch you 
can do faster than having to read all the registers, this reduces the Interrupt overhead. The 
folbwing program shows how to set up interrupts of one per second, read the time and display it in 
ttie top line of the screen. 



SOURCE 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0300: 

0300: 

0300:78 

0301 :A9 

0303 :8D 

0306 :A9 

0308:80 

030B:20 

030E:58 

030F:60 

0310: 

0310:40 

0311: 

0312: 

0312 :A5 

0314:48 

0315 :8A 

0316:48 

0317:98 

0318:48 

0319 :AE 

031C:A9 

031E:8D 

0321 :AC 

0324 :B9 

0327:10 

0329 :C9 

032B:F0 

0320:00 

032F:A8 

0330:20 

0333 :BD 

0336 :2C 

0339 :F0 

033B:C0 

0330:00 

033F:29 

0341: CO 

0343:00 

0345:29 

0347:29 

0349:09 

034B:AC 

034E:99 



FIUB #01 ■»TBI 

1 ;PROCRAM: 

2 ; FUNCTION 

3 ; 
C080 4 POITA 
C081 5 CTRLA 

6 ; 

7 ; 

NEXT OBJECT FII£ NAK IS 



TDC BY INTERWffT 
DISPIAY CIOCK DATA USING INTERRUPTS 



0300 



12 

FE 03 
03 

FF 03 
71 03 



0001 



45 



10 03 
00 

11 03 
11 03 
5F 03 

06 032F 

FF 

29 

IC 



0356 
034B 



82 03 

80 CO 

27 03 

El 031C 

05 

02 

03 

08 

02 

03 

OF 

BO 

11 03 

17 04 



0341 



0347 



8 

9 ; 

10 STftRT 
11 
12 
13 
14 
15 
16 
17 

18 ; 

19 5LOTN0 

20 COUNTCR 

21 ; 

22 INTERRUPT 
23 

24 

25 

26 

27 

28 

29 AGAIN 

30 

31 NEXT 

32 

33 B4 

34 

35 

36 

37 REGCOOE 

38 

39 

40 

41 

42 

43 

44 

45 R5 

46 

47 

48 R6 

49 

50 MARK 

51 



BQU $C080 
EQO PGRTA+1 



TBI.O 
ORG $300 

SEI 

LDA #>INTERRa>T 

STA $3FE 

LDA ♦<INTERRUPT 
$3FF 
SEL.FRBQ 



STA 
JSR 
CLI 
RTS 

DFB 
OS 

LDA 
PHA 
TXA 
PHA 
TYA 
PHA 
LOX 
LOA 
STA 
LDY 
LDA 
BPL 
CHP 
BBQ 
Bm. 
TAY 
JSR 
LOA 
BIT 
BEQ 
CPY 
BNE 

rm 

CPY 
BNE 
AND 
AND 
ORA 
LDY 
STA 



$40 
1 



$45 



sumio 

♦0 

cojfrrER 

OOiniTER 

TABLE, Y 

REGOODE 

#$FF 

EXIT 

MARK 

MXECT 

PORTA, X 

B4 

AGAIN 

#$05 

R5 

#$03 

#$08 

R6 

#$03 

#$0F 

»$B0 

COUNTER 

$417,Y 



;PORT A BASE ADH^SS 
;(X}NTROL REGISTER 



;USUAUY UNU^O MEIORY SPACE 

DISABLE INTERRIPTS 
LOAD INTERRUPT VECTm 
WITH START OF INTERtUPT 
HANDLER. 

ESTABLISH INTERRtffT RATE 
ENABLE INTCRRUPTS 
RETURN 

;FC» CLOCKNORKS IN SLOT 4 

/DEFINE STORAGE FOR FC»HAT COUNTER 

;THDE ACCOOLATOR AFTER IRQ 



SAVE REGISTERS 

BY PUSHING THEM ON THE STACK. 

;GEr INDEX TO CLOCK'S SLOT 

INITILIZE COUNTER TO ZERO 
GET FC»MAT POSITION CCKMT 
STEP THRU FORMAT TABLE 
BRANCH IF REGISTER SELECT CODE. 
CHECK IF END OF TABI£ 

YES EXIT 

NO. . . THEN IT MJST BE A Sf ARATOR 

SAVE ADDRESS CODE IN Y 

SELECT CLOCK REGISrat TO READ 

READ DATA 

CLOCK ROLLOVBl? (BPL CPCODE ° 00010000) 

START OVER TO GET A GUARANTEED READING 

CHECK IF MSB CK* HOURS 

.-MASK (»F 24 HR AND AM/PH FLAGS 
;CHECK IF MSB OF DAY OF K)NTH 

/MASK OFF LEAP YEAR tDOE SETIim 

;HAKE ASCII CODED DIGIT 
;PUT COUNTER VALUE IN Y 
/STORE DIRECTLY TO SCREEN MEMDRY 
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03S1 

0354: 

0356: 

0356: 

0359: 

035A; 

035B 

035C: 

0350: 

035E: 

035F; 

035F: 

035F 

035F 

035F 

035F 

035F 

0362 

036A 

0371 

0371 

0373 

0376 

0379 

037B 

037E 

0381 

0382 

0382 

0382 

0382 

0382 

0382 

0383 

0385 

0388 

0389 

038B 

038E 

0390 

0393 

0393 

0395 

0395 

0395 

0395 

0395 

0395 

0396 

0398 

039B 

039C 

039F 

03A1 

03M 



EE 11 03 

DO CB 0321 

20 71 03 

68 

A8 

68 

AA 

68 

40 



OA 09 AF 
08 07 AF OC 
EUV 03 02 BA 

A9 OF 
AE 10 03 
20 82 03 
A9 OC 
9D 81 CO 
BD 80 CO 
60 



48 

A9 EF 
20 95 03 
68 

09 80 
9D 80 CO 
49 AO 
90 80 CO 



A9 EO 



48 

A9 00 
90 81 CO 
:68 

90 80 CO 
:A9 04 
90 81 CO 
60 



52 
53 

54 ; 

55 EXIT 
56 
57 
58 
59 
60 
61 

62 ; 

63 ;'nffi FOLUWING TABLE COtTTBDLS THE FORMAT OF CUXK DISPLAY 

64 ;CLOCK ADDRESS CODES RANGE FKH $00 TO $0C 

65 ;PC»MATTING COOES (/, :,<SPACE>) HAVE MSB SET 

66 ;PC«MAT TERMINATCW IS $FF 

67 ; 
SQA,$09,$AF 

$08, $07, $AF, $0C, $0B, $A0, $05, $04 
SBA, $03, $02, $BA, $01, $00, $FF 



INC 


OXJNTER 


; INCREMENT COUNTER 


BNE 


NEXT 


; BRANCH ALHAYS 


JSR 


SEL.FRBQ 


; RE-ESTABLISH IWTERROPT RATE 


PLA 




;RESTC»E ALL 


TAY 




; REGISTERS 


PLA 






TAX 






PLA 






RTI 




.-RETURN FROM INTERRUPT 



DFB 
OFB 
DFB 



68 TABLE 

69 

70 

71 ; 

72 SEL.FREQ LDA #$0F 

73 LDX SLOTNO 

74 JSR SELECT 

75 LDA t$OC 

76 STA CTRLA,X 

77 LDA PORTA, X 

78 RTS 

79 ; 

80 ;LATCH ADDRESS CODE TO CLOCK 

81 ,-ON INPUT A'ADORESS COIX X=NO NHERE N IS THE SIOT t 

82 ;0N OUTPUT A IS DESTROYED. X AND Y UNAFFECTED. 

83 ; 



;SET OP INTERRUPT 

,-LQAD INDEX TO SLOT USED 



; ENABLE ONCE PER SECOND INTERRUPT 



; CLEAR INTHWUPT STATUS 



84 5EI£CT PHA 

85 LDA «$EF 

86 JSR DIRECTION 

87 PLA 

88 ORA #$80 

89 STA PORTA, X 

90 EOR «$A0 

91 STA PORTA, X 

92 ; 

93 LDA «$E0 

94 ; 

95 ;SET P(»T DIRECTION 

96 ;0N INPUT, DATA DIRECTION MASK BYTE IN A (BIT SET 

97 /PRESERVES X AND Y, A IS CLOBNKEO 

98 ; 

99 DIRECTION PHA 

100 LDA 

101 STA 

102 PIA 

103 STA 

104 LQA 

105 STA 

106 RTS 



PUSH A ON STACK 

11101111 

ALL OUTPUT EXCEPT BIT 4 

RESTCKE A FROM STACK 

NRITE AOntESS CODE TO CLOCK 

;READ DATA AT ADDRESS SELECTED 

; 11100000 (FALL INTO DIRECTIOIN ROUTINE) 



OUTPUT), SLOTNO IN X 



«0 




CTOIA,X 


SRT.Frr DIRECTION REGISTER 


PORTA, X 


SET ACODRDIMG TO "A" 


#4 




CTRIA,X 


DESELECT DIRECTION REGISTER 




RETURN 



** SOCCESOTUL ASSEMBLY :- NO ERRORS 
** ASSEWI£R CREATED ON 15-JAN-84 21:28 
** TOTAL LINES ASSEIOLED 106 
** FM;E SPACE PAGE COUNT 84 
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9.6 THE MILLISECONDS UTILITY 

On the CLOCKWORKS DOS 3.3 disk is a utility program that can be use to obtain Milliseconds. 
The name of the source code file is "MILLISECONDS" and that of the object code is 
"MILLISECONDS.0". This program bloads at $300 (hexadecimal) or 768 (decimal). Once kwded, 
the foNowing calls can be executed from your Applesoft program: 



CALL 768 Fincte CLOCKWORKS and sets location 793 to sk)tX16. A PRINT 

PEEK(793)/16 folkjwing this CALL will print the slot # of the dock. A zero 
indicates that Ck)ckworks was not found. 

CALL 771 Sets up interrupt vector, resets the counter to zero and enabbs counting. 

CALL 774 Resets the counter to zero. 

CALL 777 Copies the contents of the 3 byte counter to decimal memory bcations 787 
tfiru 789 where it wiH not be overwritten. 

CALL 780 Stops nruilisecnds counting. 

CALt. 783 Starts/continues counting after a CALL 780. 



On the same disk, the program "STOPWATCH" can be found. This program uses the Milliseconds 
utility to maintain a Milliseconds stopv^tch on tiie screen. 



SOURCE 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

0000: 



FILE #01 



C080 
C081 



•>MIUISEOONDS 
.•TOKCTION 



HIUISEOONDS 

: MUNTAIN MILLISECONDS COUNI^ IN THREE BYTES 



PC»TA 
CTOU 



EQD 
EGIO 



$C080 
PORTA+1 



NEXT OBJECT FILE NfME IS MILLISECONDS. 

ORG $300 



0300: 

0300: 

0300 :4C 

0303 :4C 

0306:40 

0309:4C 

030C:4C 

030F:58 

0310:60 

0311: 

0311:78 

0312:60 

0313: 

0313: 

0316: 



0300 



lA 03 
4B 03 
6E 03 
7D 03 
11 03 



0003 
0003 



8 
9 ; 

10 ENTRY. 1 

11 ENroY.2 

12 ENTRY. 3 

13 ENTOy.4 

14 ENTRY. 5 

15 ENTRY. 6 
16 

17 ; 

18 DISABLE 
19 

20 ; 

21 HOLD 

22 COUNTER 



jir 

JIf 
JW 
JIV 
Jiff 
CLI 
RTS 

SEI 
RTS 

DS 
DS 



FIND. SLOT 
INIT.IBQ 
RESET. CNT 
COPY. COUNT 
DISABLE 



;P(»T A BASE ADDRESS 
;C0NTlOL REGISTER 



.-USUALLY UNUSED MEMORY SPACE 

CALL 768 LOCATES CLOCK SLOT 

CALL 771 STARTS MILISEOONDS COUNTER 

CALL 774 RESETS 3 BYTE COUNTER TO ZEROES 

CALL 777 OOPY COUNTER TO HOLDING AREA 

CALL 780 STCffS COUNTING 

CALL 783 CONTINUES COUNTING 



;SET INTERRUPT DISABLE FLAG 



/RESERVE THREE BYTES FOR SAFE STORAGE 
; RESERVE THREE BYTES FC» COUNTING 
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0319: 


0001 


23 SIOTKO 


OS 


1 


031A: 




24 ; 






031A:A2 C7 




25 FINO.SIOI 


LOX 


♦$C7 


031C:8E 49 


03 


26 NEXT 


STX 


CIff.R0Hf2 


031F:A0 00 




27 


LDY 


*0 


0321:20 47 


03 


28 


JSR 


off.noH 


0324 :C9 08 




29 


CH" 


#8 


0326:00 11 


0339 


30 


BNE 


NOHATCH 


0328 :A0 FC 




31 


LDY 


1252 


032A:20 47 


03 


32 


JSR 


CHK.ROM 


032D:C9 C3 




33 


CHP 


♦195 


032F:D0 08 


0339 


34 


BNE 


NOMATCH 


0331 :C8 




35 


INY 




0332:20 47 


03 


36 


JSR 


OK. RON 


0335 :C9 07 




37 


at 


♦215 


0337 :F0 05 


033E 


38 


BGQ 


FC3UNDIT 


0339 :CA 




39 NOMATCH 


OEX 




033A:E0 CO 




40 


CPX 


♦SCO 


033C:D0 OE 


031C 


41 


BNE 


NEXT 


033E: 




42 ; 






033E:8A 




43 FOUMOIT 


TXA 




033F:0A 




44 


A5L 


A 


0340 :0A 




45 


ASL 


A 


0341 :0A 




46 


ASL 


A 


0342 :0A 




47 


ASL 


A 


0343:80 19 03 


48 


STA 


SLOTNO 


0346:60 




49 


RTS 




0347: 




50 ; 






0347 :B9 00 C7 


51 CHK.RM4 


LDA 


$C700,Y 


034A:60 




52 


RTS 




034B: 




53 ; 






034B:78 




54 miT.IHQ 


SEI 




034C:A9 8C 




55 


LOA 


♦>INTEI®DPT 


034E:8D FE 03 


56 


STA 


$3FE 


0351 :A9 03 




57 


LDA 


♦<INTERRCrr 


0353:80 FF 03 


58 


STA 


S3FF 


0356 :A9 OF 




59 


LDA 


♦$0F 


0358 :AE 19 03 


60 


WX. 


SLOTNO 


03SB:20 A3 03 


61 


jai 


SELECT 


035E:A9 05 




62 


LDA 


♦$05 


0360:90 81 CO 


63 


STA 


CTRLAfX 


0363 :BD 80 CO 


64 


LDA 


PORTA, X 


0366:20 6E 03 


65 


JSR 


RESET.CNT 


0369:20 70 03 


66 


ja» 


COPY.CCXJNT 


036C:58 




67 


CLI 




0360:60 




68 


RTS 




036E: 




69 ; 






036E:08 




70 RESET.CNT PHP 




036F:7B 




71 


SEI 




0370 :A9 00 




72 


LDA 


♦0 


0372:80 16 


03 


73 


STA 


CDONTER 


0375:80 17 


03 


74 


STA 


OOUNTER+1 


0378:80 18 


03 


75 


STA 


OOONTER+2 


037B:28 




76 


PIf 




037C:60 




77 


RTS 




037O: 




78 ; 






0370:08 




79 CC3PY. COUNT PHP 




037E:78 




80 


SEI 




037F:A2 02 




81 


LDX 


♦2 


0381 :B0 16 


03 


82 ALL3 


LOA 


COUNTER, X 


0384:90 13 


03 


83 


STA 


HOt,D,X 



;ONE BYTC FOR SLOT ♦ IN HIGH NIBBLE 



; START WITH SLOT 7 
;SELF MODIFYING SEMCH 



,-LOOK FOR 'PHP' AT 5CN00 



;LOOK FOR HI ASCII 'C AT $CNFC 



.-LOOK FOR HI ASCII 'W AT $CNFO 



;ALL SLOTS CHECKED? 
;N0, DO NEXT SLOT 



;PDT SLOT^ X16 AT 'SLOTNO* 



DISABLE INTERHOPTS 
LOAD INTERRUPT VECTOR 
WITH START OF INTCRPDPT 
HANDI£R. 



.-ENABLE REFEI^NCE FREQOBfCIES 
;FOR MILLISBOONDS 

;CI£M PIA STAOUS 
/RESET OOONTER TO ZERO 
;R^BT HOLD 00(MTER 
.•START OODNTING 
.■RETURN 

.-SAVE PROCESSOR STATUS 
.-DISJffiLE INTERROPS 



.•RESET ALL TffilEE BYTES TO ZERO 

.•RESTORE PROCESSCHt STATUS 
.•RETtBN 

.■SAVE PROCESSOR STATUS 
fOISMLE INTERKlffTS 
;3 BYTES TO COPY 
.-GET COUNTER BYTE 
;PUT IN SAFE PLACE 
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0387; 
0388: 
038A: 
038B; 
038C; 
038C; 
038D: 
038E: 
0391; 
0394; 
0396; 
0399; 
039B; 
039C; 
039E; 
03»; 
03A0: 
03A2; 
03A3; 
Q3A3; 
03A3; 
03A3; 
03A3; 
03A3; 
03A4; 
03A6; 
03A9; 
03AA; 
03AC; 
03AF; 
03B1; 
03B4; 
03B4: 
03Bfi; 
03B6; 
03B6; 
0366; 
03B6; 
03B6; 
03B7; 
03B9; 
03BC; 
03BD; 
03C0; 
03C2; 
03C5; 



0396 



CA 

10 F7 0381 

28 

60 

8A 
48 

AE 19 03 

BO 80 CO 

A2 02 

FE 16 03 

DO 03 Q39E 

CA 

10 F8 

68 

AA 

AS 45 

40 



48 

A9 EF 
20 B6 03 
68 

09 80 
9D 80 CO 
49 AO 
9D 80 CO 

A9 EO 



48 

A9 00 

9D 81 CO 

68 

9D 80 CO 

A9 04 

9D 81 CO 

60 



ALL3 



SIX)TNO 
PORTA, X 
#2 

COUNTER, X 
EXIT. IRQ 

INCREMENT 



84 DEX 

85 BPL 

86 PLP 

87 RTS 

88 ; 

89 INTERRUPT TXA 

90 PHA 

91 LDX 

92 LDA 

93 LDX 

94 INOtEMENT INC 

95 BNE 

96 DEX 

97 BPL 

98 EXIT. IRQ PIA 

99 TAX 

100 LDA $45 

101 RTI 

102 ; 

103 .-LATCH AOE»ESS COCG TO CLOCK 

104 ;C»I INPUT A>ADDRESS COK X>N0 WHERE N IS THE SU/T « 

105 ;0N OUTPUT A IS DESTODYED. X AND Y UNAFFECTED. 

106 ; 

107 SEI£CT PHA 



NEXT BYTE 

RESTC»E PROCESSOR STATUS 
RETUW 

JUX ALREADY SAVE D IN $45 
SAVE X BY POSHING IT ON STACK 
GET INDEX TO SLOT 
RESET INTERRUPT FLAG 

INCREMENT 3 BYTE OOONTER 



;RESTORE X REGISTER 

.-RESTORE ACCa4ILATC» 
;RETI^W FROM INTERRUPT 



PUSH A ON STACK 

11101111 

AU OUTPUT EXCEPT BIT 

RESTORE A FROt STACK 



108 LDA «$EF 

109 JSR DIRECTION 

110 PLA 

111 ORA «$80 

112 STA P(»TA,X 

113 E(» t$AO 

114 STA PORTA, X 

115 ; 

116 LDA t$EO 

117 ; 

118 ;SET P(»T DIRECTIOI 

119 ,-ON INPUT, DATA DIRECTION MASK BYTE IN A (BIT SET 

120 ; PRESERVES X AND Y, A IS CUBBERED 

121 ; 

122 DIRECTION PHA 

123 LDA to 

124 STA CTRLA,X 

125 PLA 

126 STA P(»TA,X 

127 LDA «4 

128 STA CTRLA,X 

129 RTS 



NRITE ADDRESS CODE TO CLOCK 



/READ DATA AT ADDRESS SELECTED 



,-11100000 (FALL INTO DIRECTIOIN ROUTINE) 



OUTPUT), SLOTNO IN X 



SELECT DIRECTIM REGISTER 



SET ACCORDING TO "A" 



DESELECT OIIffiCTION REGISTER 
RETURN 



** SUCCESSFUL ASSEMBLY :- IK> ERRORS 
** ASSEMBIER CREATED ON 15-JAN-84 21:28 
** TOTAL LINES ASMJ©LED 129 
** FREE SPACE PAGE COUNT 83 
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APPENDIX A 

ADJUSTING THE TIME BASE FREQUENCY 



The accuracy of the time keeping performed by Ck)ckworks is dependant on the time l>ase 
frequency generated t)y the small quartz oystal labled 'XTAU. The crystal oscillates at 32768 Hz. A 
fine tuning capacitor (kicated on the right side of the crystal) was perdseiy calibrated at the factory. 
The accuracy is also somewhat affected by the temperature in your Apple, if you notice that the 
ck)ck is too fast or too slow you may wish to adjust the tuning capacitor by turning the screw a very 
smaH amount counter ckjckwise to slow the ck)ck down or ctockwise to speed it up. 
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APPENDIX B 

TESTING THE BATTERY 



The litNun colnoell battery on yow Ck)ckworks is RistaHed m a Ngh qualtty battery holder for easy 
re|:^2K»ment, imder riormal use you wiR not need to change this battery for many years. But if you 
notice that the time is erroneous after you tum on the Apple try setting ttie time, if this does not help 
or if the problem recurs you'H need to check the battery vdtage. 

To do this you will need a Voltmeter, preferably the digital type. Tum off your Apple and remove 
your Ck)ckworks card (HANDLE WITH CARE). Make sure your voltmeter is set up to measure volts. 
On the circuit skfe of tfie card right behind the battery there are two terminals (Hace the tip of one 
probe of your vtotmeter on one terminal and the other tip on tfw other terminal. 

If the battery reads bek)W 2.6 volts then you shouM replace it with a new one. These batteries are 
available from several electronns supply houses or you can order one directly from us. 
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APPENDIX C 

TECHNICAL SPECIFICATIONS & FEATURES 



* High quality quartz crystal time l>ase. 

* 24 hour military or 12 hour AM/PM formats. 

* High capacity litNum battery t>ackup. 

* Fully ProDOS and DOS 3.3 compatible. 

* Four interrupt frequencies 1024 Hz. 1 per second, 1 per minutB, and 1 per hour, 

* Two levels of Intemjpts "IRQ" and "NMI". 

* Supplies the date wHh month, day of month, year, the day of the week, the hours, minutes 
and seconds. 

* An kJeal substitute for any other cfock because of the eight built-in formats. 

* Super smart firmware in 4096 bytes of EPROM. 

* Two set time modes aWow setting the dock with a simple print command. 

* BuM m BSR control command set. 

* Automatically detects and corrects lor leap years. 

* On-board bMirectfonal 8-bit port with 2 handshake lines. 

* AuxBiary connector ¥wth +5,+12,-5.and -12 volts and a 1MHz ctock reference signals. 

* AuxHiary connector can be used to drive BSR control, direct control, printer driver. A/D and 
D/A converskxis, and more.... 
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APPENDIX D 

QUICK REFERENCE SUMMARY 





READ MODES: 


LANGUAGE 


■ ■ 


06/24 14:35:45.185 


APPLESOFT BASIC 


% 


MC»I JUN 24 02:35:45 PM 


APPLESOFT BASIC 


« 


MCW JUN 24 14:35:45 


APPLESOTT BASIC 


♦ 


06,01,24,14,35,45 


APPLESOFT BASIC 


> 


HON JUN 24 02:35:45 PM 


INTEGER BASIC 


< 


MON JUN 24 14:35:45 


INTEGER BASIC 




1 06/24/85 14:35:45 


APPLESOFT BASIC 


m 


01,06,24,85,14,35,45 


APPLESOFT BASIC 


W COLUMN COMMAND FORMAT: 





CALL 49216 + 256 * SLOT,FMS,TMS 

Where fm$ is a one character string indicating tfie read format, and TM$ is the variat}le nanie in 
which the ck>ck data wiU be placed. 



SET TIME COMMAND FORMATS; 



CLOCKWORKS SET MODE: 
THUDERaOCK SET MODE: 



+W MO DD YY HH HI SS <RETURN> 
!M0 H DD HH MI SS <RETUV4> 



The letter Z may be included in the string to zero out fractions of seconds to precisely set the time 

to better than 1/32 of a second accuracy. 

Placement of the letter T at the liegining of strings that set the second is recommended. 



BSR CONTROL COMMANDS 



CHARACTER 


fiuimti 


A 


1 


B 


2 


C 


3 


D 


4 


E 


5 


F 


6 


G 


7 


H 


8 


1 


9 


J 


10 


K 


11 



CHARACTER 


mim 


L 


12 


M 


13 


N 


14 





15 


P 


16 


Q 


ON 


R 


OFF 


S 


BRIGHT 


T 


DIM 


U 


ALLUGHTSON 


V 


ALL OFF 



The "*' character, when ouput to the clock, indicates that the next character to be a duratk)n code. 
This can be any letter from "A" (minimum) through "Z" (maximum). 



